home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Source Code / C / Applications / Portable Patmos 1.1 / README.LATEST < prev    next >
Encoding:
Text File  |  1996-07-05  |  2.4 KB  |  47 lines  |  [TEXT/ttxt]
  1. Portable Patmos 1.1 README
  2.  
  3. See README.ORIGINAL for a discussion of the original version of Patmos
  4.  
  5. Enclosed is a cut down version of Patmos that runs on non-quadras and powermacs. This makes it much less useful for debugging but nevertheless it provides access to the GNU compiler/make suite which is of interest.
  6.  
  7. Getting started.
  8.  
  9. Turn off virtual memory or RAM Doubler before attempting to run Patmos. Other obscure system extensions could interfere as well. You can still use Autodoubler etc. if you have it to reduce the size of your executables. Since all filing system calls are via the toolbox, the operation of this type of program is transparent to Patmos.
  10.  
  11. You can startup by simply double-clicking the Patmos application. It will open the "sh" program automatically. Note that the location of the sh program becomes the root of the filing system for that session, so you will need two copies of sh, one in your root folder, and one in your /bin folder.
  12.  
  13. To compile and run a program you will need 
  14.  
  15.      /usr/lib/crt0.o 
  16.      /usr/lib/libgcc.a 
  17.      /usr/lib/libc.a
  18.      /usr/bin/{gcc,cpp,cc1,as,ld}
  19.  
  20. You can prepare your source code with an editor such as the freeware BBEdit. Bee sure to choose the ‘UNIX line endings’ option when you save the source file. THIS IS REALLY IMPORTANT. Without UNIX line endings, the source code files will be unrecognizable to the compiler.
  21.  
  22. To compile a program, type something similar to the following:
  23.  
  24.      gcc hello.c where hello.c is your program
  25.  
  26. This will generate an executable in the current directory, called a.out by
  27. default. Run this program by typing
  28.  
  29.      a.out
  30.  
  31.  
  32. License.
  33.  
  34. The Patmos kernel is copyright ©1994 by Jonathan Richard Robert Kimmitt. It
  35. also incorporates as well as the author’s work, libraries which are copyright the University of California (Berkley). The dissassembly that you get when a program crashes is copyright Free Software Foundation, as is the majority of the application software including the compiler. You may freely copy this software but you must make the source code available to anybody you distribute this software to, or tell them where they can get it. For full details, see the file COPYING
  36.  
  37. If you like this program, send a postcard with your suggestions for improvements, what mac you tried it on, etc. to
  38.  
  39. Jonathan Kimmitt
  40. 4 Moyne Close,
  41. Cambridge,
  42. CB4 2TA
  43. ENGLAND
  44.  
  45. Or if you are excessively lazy, you can send e-mail with your feedback to
  46. jrrk@camcon.co.uk
  47.